home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Almathera Ten Pack 3: CDPD 3
/
Almathera Ten on Ten - Disc 3: CDPD3.iso
/
scope
/
001-025
/
scopedisk22
/
gwprint
/
gwprint.doc
< prev
next >
Wrap
Text File
|
1995-03-18
|
6KB
|
172 lines
gwPRINT.doc document for 23-may-87
`gwPRINT' an AMIGA Program to Format the Printing of Text Files.
gwPRINT was designed to make the printing of textfiles with margins,
headers, and a large range of other user preferences a simple task.
Output is to the Printer Device, which must be installed properly.
A few minutes of playing with the gadgets will reveal their simplicity.
Note that some are toggled to a different values when you click them.
Some are standard Integer and String gadgets and some control the
printing process.
Header Gadgets:
==============
`Style' determines how the header is printed.
`Title' if ON, the string in the other `Title' gadget is used for
the left part of the header.
`Date' if ON, the system date is placed in the center of the header.
`Page Nos' if ON, places page numbers in the right portion of the header.
The `Title' & `Date' & `Page Nos' must all be turned off to
completely eliminate a header.
If the `Page Len' is zero, at most, only one header will be
printed at the beginning of the document.
Format Gadgets:
==============
`Pitch' determines the size of print characters for the text file.
`Quality' determines print quality of the text.
`LPI' Lines Per Inch.
`Left Mar' determines the print position of the leftmost character in
each line of the document. Also used with the header.
Note, multiples of 8 for simplicity,
`Page Len' Page Length can be set to zero to disable paging.
Relative to Lines Per Inch.
`Pg 1 Off' Page 1 Offset allows the first page of a document to be
shorter than the others to compensate for printers which align
paper so you so you can't print get at the first few lines of
the first page.
`Vert Mar' Vertical Margins specify the number of blank lines for the
top and bottom margins and if there is a header, the space
between it and the first line of text on a page.
`Right Mar' Right Margin, the last column to be printed in. Also used with
the header.
Other Gadgets:
=============
`File' A valid file specification string for the file to be printed.
When gwPrint first starts, it places the first CLI argument
to initalize this gadget. If there are no CLI arguments,
the `File' gadget is automatically activated.
`Title' A string for the header.
Each time the File gadget detects a return it sets the `Title'
gadget to the filespec with the Dos path removed. But, only
if the gadget is empty. Use the Amiga x to clear it.
Control Gadgets:
===============
`Begin' Starts the printing according to the current settings.
`Pause/Cont' Toggles the Printing and Holding modes.
`Abort' Aborts the current file being printed.
Error Conditions:
================
Error Opening File - File Not Found.
Error Reading File -
Error Opening Printer - Printer Device Busy.
Error Writing Printer - Printer off line.
Empty File -
Bad Text - a null byte was found in text file.
Weird Settings - one or more of the integer gadgets contains number(s)
which describe an impossible format.
Check for negative values, large vertical margins,
or a right margin smaller than the left.
Misc Notes:
==========
To Print only one page header per document set the page length to zero
and turn on the desired header gadgets.
Titles can be 79 characters long, but the `Date' and `Page Nos' gadgets
may need to be off to prevent conflicts.
Once a printing is started you can change the gadgets settings for the next
printout without affecting the current printing.
Often I edit a document using the full 80 columns of the display and no
margins. To print this file, I set the Left Margin gadget to 9 and the
Pitch gadget to elite. This gives me a document with nice margins and
a full 80 characters on a line. This also takes the margin information
out of the file to decrease its size and makes it easier to wordprocess.
Be aware that printers with large buffers will accept data much quicker
than they can print it. So, if you hit `Abort' or `Pause/Continue' the
program will stop sending data immediately, but the printer may take
awhile to finish printing what its already received.
gwPrint will execute from a WorkBench Icon or the CLI and opens a window
in the WorkBench screen.
Some printers may not support all of gwPrint's options.
The printer device is only Open while actually sending data to the printer.
When printing a counter tracks the number of text lines sent to the printer.
A formfeed gadget, a reset printer gadget, and file requester were
not included for overhead reasons.
Development:
===========
AmigaDos 1.2, Lattice 3.03, BLink65, AStartup, and `FixHunk'd for the big boys.
Every effort was made to ensure a safe, efficient, productive Amiga Program.
Lattice 3.10 generated an object file almost 50% larger.
Bugs/Quirks:
===========
Currently, with the Okidata92 driver I get a single linefeed when the
Printer Device is opened for the first time. This causes only the first
document printed after a boot to be shifted down one row on the page.
It must be in my driver ????
Doesn't properly handle filenames with embedded spaces from the CLI.
============================================================================
`gwPrint' an AMIGA Program to Format the Printing of Text Files.
Copyright (c) 1987 by Gaylan D. Wallis ; ALL RIGHTS RESERVED
Permission is granted to use, copy, and distribute the program `gwPRINT'
providing that no fee shall be charged for such copying and distribution,
and that both `gwPRINT' and `gwPRINT.doc' are distributed together and in
their unmodified state.
gwPrint is offered `as is' under `ShareWare' terms. Please try it and
pass it on. When and if you discover it worth having. Please consider a
small voluntary contribution that I may continue to produce more and better
Amiga Software.
Contributions, Suggestions, Comments and Request should be sent to:
Gaylan Wallis
1324 Parkwoods Terr.
Midwest City, Ok 73110
bix: gwallis Ace BBS OKC (405)-631-9040